home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / makepsres.z / makepsres
Text File  |  1998-10-20  |  11KB  |  265 lines
  1.  
  2.  
  3.  
  4.      MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))       AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((11113333 MMMMaaaayyyy 1111999999993333))))       MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           makepsres - Build PostScript resource database file.
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           mmmmaaaakkkkeeeeppppssssrrrreeeessss [ _o_p_t_i_o_n_s ] _d_i_r_e_c_t_o_r_y ...
  14.  
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.           mmmmaaaakkkkeeeeppppssssrrrreeeessss creates PostScript language resource database
  18.           files.  Resource database files can be used to specify the
  19.           location of resources that are used by the font selection
  20.           panel and other Adobe software.  For a complete description
  21.           of the resource location facilities in the Display
  22.           PostScript system, see Appendix A and Appendix B of "Display
  23.           PostScript Toolkit for X" in _P_r_o_g_r_a_m_m_i_n_g _t_h_e _D_i_s_p_l_a_y
  24.           _P_o_s_t_S_c_r_i_p_t _S_y_s_t_e_m _w_i_t_h _X.
  25.  
  26.           mmmmaaaakkkkeeeeppppssssrrrreeeessss creates a resource database file named _P_S_r_e_s._u_p_r
  27.           that contains all the resources in all the _d_i_r_e_c_t_o_r_y path
  28.           names specified on the command line.
  29.  
  30.             If the list of directories contains ---- ,,,, mmmmaaaakkkkeeeeppppssssrrrreeeessss reads
  31.             from _s_t_d_i_n and expects a list of directories separated by
  32.             space, tab, or newline.
  33.  
  34.             If the list of directories is empty, it is taken to be the
  35.             current directory.
  36.  
  37.             If all specified directories have a common initial prefix,
  38.             mmmmaaaakkkkeeeeppppssssrrrreeeessss extracts it as a directory prefix in the new
  39.             resource database file.
  40.  
  41.           mmmmaaaakkkkeeeeppppssssrrrreeeessss normally acts recursively; it looks for resource
  42.           files in subdirectories of any specified directory. This
  43.           behavior can be overridden with the command line option ----nnnnrrrr....
  44.  
  45.           mmmmaaaakkkkeeeeppppssssrrrreeeessss uses existing resource database files to assist in
  46.           identifying files. By default, mmmmaaaakkkkeeeeppppssssrrrreeeessss creates a new
  47.           resource database file containing all of the following that
  48.           apply:
  49.  
  50.             Resource files found in the directories on the command
  51.             line.
  52.  
  53.             Resource files pointed to by the resource database files
  54.             in the directories on the command line.
  55.  
  56.             Resource entries found in the input resource database
  57.             files. These entries are copied if the files they specify
  58.             still exist and are located in directories not specified
  59.             on the command line.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))       AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((11113333 MMMMaaaayyyy 1111999999993333))))       MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))
  71.  
  72.  
  73.  
  74.           If you run mmmmaaaakkkkeeeeppppssssrrrreeeessss in discard mode (with the ----dddd option),
  75.           it does not copy resource entries from the input resource
  76.           database files. In that case, the output file consists only
  77.           of entries from the directories on the command line. The
  78.           input resource database files are only used to assist in
  79.           identifying files.
  80.  
  81.           If you run mmmmaaaakkkkeeeeppppssssrrrreeeessss in keep mode (with the ----kkkk option), it
  82.           includes in the output file all resource entries in the
  83.           input resource database files, even entries for files that
  84.           no longer exist or are located in directories specified on
  85.           the command line.
  86.  
  87.           mmmmaaaakkkkeeeeppppssssrrrreeeessss uses various heuristics to identify files. A file
  88.           that is of a private resource type or that does not conform
  89.           to the standard format for a resource file must be specified
  90.           in one of the following ways:
  91.  
  92.             By running mmmmaaaakkkkeeeeppppssssrrrreeeessss in interactive mode
  93.  
  94.             By preloading the file into a resource database file used
  95.             for input
  96.  
  97.             By beginning the file with the following line:
  98.  
  99.                %!PS-Adobe-3.0 Resource-<resource-type>
  100.  
  101.  
  102.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  103.           ----oooo _f_i_l_e_n_a_m_e
  104.                Writes the output to the specified filename.  The
  105.                construction "----oooo ----" writes to stdout. If the ----oooo option
  106.                is not specified, mmmmaaaakkkkeeeeppppssssrrrreeeessss creates a _P_S_r_e_s._u_p_r file in
  107.                the current directory and writes the output to that
  108.                file.
  109.  
  110.           ----ffff _f_i_l_e_n_a_m_e
  111.                Uses information from the specified file to assist in
  112.                resource typing. The file must be in resource database
  113.                file format.  Multiple ----ffff options may be specified. The
  114.                construction "----ffff ----" uses _s_t_d_i_n as an input file and may
  115.                not be used if "----" is specified as a directory on the
  116.                command line.
  117.  
  118.           ----ddddiiiirrrr _d_i_r_n_a_m_e
  119.                Specifies that _d_i_r_n_a_m_e is a directory. Needed only in
  120.                rare cases when _d_i_r_n_a_m_e is the same as a command-line
  121.                option such as ----nnnnbbbb....
  122.  
  123.           ----dddd   Specifies discard mode. The resulting output file
  124.                consists solely of entries from the directories on the
  125.                command line.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))       AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((11113333 MMMMaaaayyyy 1111999999993333))))       MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))
  137.  
  138.  
  139.  
  140.           ----eeee   Marks the resulting _P_S_r_e_s._u_p_r file as exclusive.  This
  141.                option makes the resource location library run more
  142.                quickly since it does not have to look for other
  143.                resource database files. It becomes necessary, however,
  144.                to run mmmmaaaakkkkeeeeppppssssrrrreeeessss whenever new resources are added to
  145.                the directory, even if the resources come with their
  146.                own resource database file.
  147.  
  148.           ----iiii   Specifies interactive mode. In interactive mode, you
  149.                will be queried for the resource type of any
  150.                encountered file that mmmmaaaakkkkeeeeppppssssrrrreeeessss cannot identify.  If ----iiii
  151.                is not specified, mmmmaaaakkkkeeeeppppssssrrrreeeessss assumes an unidentifiable
  152.                file is not a resource file.
  153.  
  154.           ----kkkk   Specifies keep mode.
  155.  
  156.           ----nnnnbbbb  If the output file already exists, do not back it up.
  157.  
  158.           ----nnnnrrrr  Specifies nonrecursive mode. mmmmaaaakkkkeeeeppppssssrrrreeeessss normally acts
  159.                recursively: it looks for resource files in
  160.                subdirectories of any specified directory. If ----nnnnrrrr is
  161.                used, mmmmaaaakkkkeeeeppppssssrrrreeeessss does not look in subdirectories for
  162.                resource files.
  163.  
  164.           ----pppp   Specifies no directory prefix.  If ----pppp is used,
  165.                mmmmaaaakkkkeeeeppppssssrrrreeeessss does not try to find a common directory
  166.                prefix among the specified directories.
  167.  
  168.           ----qqqq   Quiet mode: ignores unidentifiable files instead of
  169.                warning about them.
  170.  
  171.           ----ssss   Specifies strict mode.  If ----ssss is used, mmmmaaaakkkkeeeeppppssssrrrreeeessss
  172.                terminates with an error if it encounters a file it
  173.                cannot identify.
  174.  
  175.  
  176.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  177.           mmmmaaaakkkkeeeeppppssssrrrreeeessss ....
  178.                Creates a resource database file that contains all the
  179.                resources in the current directory.
  180.  
  181.           mmmmaaaakkkkeeeeppppssssrrrreeeessss ----iiii ----oooo llllooooccccaaaallll....uuuupppprrrr ////uuuussssrrrr////llllooooccccaaaallll////lllliiiibbbb////ppppssss////ffffoooonnnnttttssss
  182.                Runs mmmmaaaakkkkeeeeppppssssrrrreeeessss in interactive mode and creates a
  183.                resource database file named _l_o_c_a_l._u_p_r, which contains
  184.                all the resources in the directory
  185.                /_u_s_r/_l_o_c_a_l/_l_i_b/_p_s/_f_o_n_t_s.
  186.  
  187.  
  188.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  189.           _P_r_o_g_r_a_m_m_i_n_g _t_h_e _D_i_s_p_l_a_y _P_o_s_t_S_c_r_i_p_t _S_y_s_t_e_m _w_i_t_h _X (Addison-
  190.           Wesley Publishing Company, Inc., 1993).
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))       AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((11113333 MMMMaaaayyyy 1111999999993333))))       MMMMAAAAKKKKEEEEPPPPSSSSRRRREEEESSSS((((1111))))
  203.  
  204.  
  205.  
  206.      AAAAUUUUTTTTHHHHOOOORRRR
  207.           Adobe Systems Incorporated
  208.  
  209.  
  210.      NNNNOOOOTTTTEEEESSSS
  211.           PostScript and Display PostScript are trademarks of Adobe
  212.           Systems Incorporated which may be registered in certain
  213.           jurisdictions.
  214.  
  215.           Copyright (c) 1989-1994 Adobe Systems Incorporated.  All
  216.           rights reserved.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.